<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>get_structured_light_object [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_inspection.html">Inspection</a> / <a href="toc_inspection_structuredlight.html">Structured Light</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">get_structured_light_object</span><span data-if="c" style="display:none;">T_get_structured_light_object</span><span data-if="cpp" style="display:none;">GetStructuredLightObject</span><span data-if="dotnet" style="display:none;">GetStructuredLightObject</span><span data-if="python" style="display:none;">get_structured_light_object</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">get_structured_light_object</span><span data-if="c" style="display:none;">T_get_structured_light_object</span><span data-if="cpp" style="display:none;">GetStructuredLightObject</span><span data-if="dotnet" style="display:none;">GetStructuredLightObject</span><span data-if="python" style="display:none;">get_structured_light_object</span></code> — Get (intermediate) iconic results of a structured light model.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>get_structured_light_object</b>( : <a href="#Object"><i>Object</i></a> : <a href="#StructuredLightModel"><i>StructuredLightModel</i></a>, <a href="#ObjectName"><i>ObjectName</i></a> : )</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>T_get_structured_light_object</b>(Hobject* <a href="#Object"><i>Object</i></a>, const Htuple <a href="#StructuredLightModel"><i>StructuredLightModel</i></a>, const Htuple <a href="#ObjectName"><i>ObjectName</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>GetStructuredLightObject</b>(HObject* <a href="#Object"><i>Object</i></a>, const HTuple&amp; <a href="#StructuredLightModel"><i>StructuredLightModel</i></a>, const HTuple&amp; <a href="#ObjectName"><i>ObjectName</i></a>)</code></p>
<p>
<code><a href="HObject.html">HObject</a> <a href="HStructuredLightModel.html">HStructuredLightModel</a>::<b>GetStructuredLightObject</b>(const HTuple&amp; <a href="#ObjectName"><i>ObjectName</i></a>) const</code></p>
<p>
<code><a href="HObject.html">HObject</a> <a href="HStructuredLightModel.html">HStructuredLightModel</a>::<b>GetStructuredLightObject</b>(const HString&amp; <a href="#ObjectName"><i>ObjectName</i></a>) const</code></p>
<p>
<code><a href="HObject.html">HObject</a> <a href="HStructuredLightModel.html">HStructuredLightModel</a>::<b>GetStructuredLightObject</b>(const char* <a href="#ObjectName"><i>ObjectName</i></a>) const</code></p>
<p>
<code><a href="HObject.html">HObject</a> <a href="HStructuredLightModel.html">HStructuredLightModel</a>::<b>GetStructuredLightObject</b>(const wchar_t* <a href="#ObjectName"><i>ObjectName</i></a>) const  <span class="signnote">
            (
            Windows only)
          </span></code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>GetStructuredLightObject</b>(out <a href="HObject.html">HObject</a> <a href="#Object"><i>objectVal</i></a>, <a href="HTuple.html">HTuple</a> <a href="#StructuredLightModel"><i>structuredLightModel</i></a>, <a href="HTuple.html">HTuple</a> <a href="#ObjectName"><i>objectName</i></a>)</code></p>
<p>
<code><a href="HObject.html">HObject</a> <a href="HStructuredLightModel.html">HStructuredLightModel</a>.<b>GetStructuredLightObject</b>(<a href="HTuple.html">HTuple</a> <a href="#ObjectName"><i>objectName</i></a>)</code></p>
<p>
<code><a href="HObject.html">HObject</a> <a href="HStructuredLightModel.html">HStructuredLightModel</a>.<b>GetStructuredLightObject</b>(string <a href="#ObjectName"><i>objectName</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>get_structured_light_object</b>(<a href="#StructuredLightModel"><i>structured_light_model</i></a>: HHandle, <a href="#ObjectName"><i>object_name</i></a>: MaybeSequence[str]) -&gt; HObject</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p>With 该算子 <code><span data-if="hdevelop" style="display:inline">get_structured_light_object</span><span data-if="c" style="display:none">get_structured_light_object</span><span data-if="cpp" style="display:none">GetStructuredLightObject</span><span data-if="com" style="display:none">GetStructuredLightObject</span><span data-if="dotnet" style="display:none">GetStructuredLightObject</span><span data-if="python" style="display:none">get_structured_light_object</span></code> you can
access and inspect (intermediate) iconic results of a structured light
measurement setup that has already been decoded using
<a href="decode_structured_light_pattern.html"><code><span data-if="hdevelop" style="display:inline">decode_structured_light_pattern</span><span data-if="c" style="display:none">decode_structured_light_pattern</span><span data-if="cpp" style="display:none">DecodeStructuredLightPattern</span><span data-if="com" style="display:none">DecodeStructuredLightPattern</span><span data-if="dotnet" style="display:none">DecodeStructuredLightPattern</span><span data-if="python" style="display:none">decode_structured_light_pattern</span></code></a>.
</p>
<p>On the one hand, this is useful to query the results of the decoding process
(<i><span data-if="hdevelop" style="display:inline">'correspondence_image'</span><span data-if="c" style="display:none">"correspondence_image"</span><span data-if="cpp" style="display:none">"correspondence_image"</span><span data-if="com" style="display:none">"correspondence_image"</span><span data-if="dotnet" style="display:none">"correspondence_image"</span><span data-if="python" style="display:none">"correspondence_image"</span></i>) together with further processed results
i.e. the defect image (<i><span data-if="hdevelop" style="display:inline">'defect_image'</span><span data-if="c" style="display:none">"defect_image"</span><span data-if="cpp" style="display:none">"defect_image"</span><span data-if="com" style="display:none">"defect_image"</span><span data-if="dotnet" style="display:none">"defect_image"</span><span data-if="python" style="display:none">"defect_image"</span></i>).
On the other hand, <code><span data-if="hdevelop" style="display:inline">get_structured_light_object</span><span data-if="c" style="display:none">get_structured_light_object</span><span data-if="cpp" style="display:none">GetStructuredLightObject</span><span data-if="com" style="display:none">GetStructuredLightObject</span><span data-if="dotnet" style="display:none">GetStructuredLightObject</span><span data-if="python" style="display:none">get_structured_light_object</span></code> is also useful for
troubleshooting the decoding process.
Note that to collect the intermediate results, the <i><span data-if="hdevelop" style="display:inline">'persistence'</span><span data-if="c" style="display:none">"persistence"</span><span data-if="cpp" style="display:none">"persistence"</span><span data-if="com" style="display:none">"persistence"</span><span data-if="dotnet" style="display:none">"persistence"</span><span data-if="python" style="display:none">"persistence"</span></i>
mode has to be enabled for the <a href="#StructuredLightModel"><i><code><span data-if="hdevelop" style="display:inline">StructuredLightModel</span><span data-if="c" style="display:none">StructuredLightModel</span><span data-if="cpp" style="display:none">StructuredLightModel</span><span data-if="com" style="display:none">StructuredLightModel</span><span data-if="dotnet" style="display:none">structuredLightModel</span><span data-if="python" style="display:none">structured_light_model</span></code></i></a>
(see <a href="set_structured_light_model_param.html"><code><span data-if="hdevelop" style="display:inline">set_structured_light_model_param</span><span data-if="c" style="display:none">set_structured_light_model_param</span><span data-if="cpp" style="display:none">SetStructuredLightModelParam</span><span data-if="com" style="display:none">SetStructuredLightModelParam</span><span data-if="dotnet" style="display:none">SetStructuredLightModelParam</span><span data-if="python" style="display:none">set_structured_light_model_param</span></code></a>) <i>before</i>
decoding the model.
</p>
<h3>Objects that can be accessed without persistence mode enabled:</h3>
<dl class="generic">

<dt><b><i><span data-if="hdevelop" style="display:inline">'correspondence_image'</span><span data-if="c" style="display:none">"correspondence_image"</span><span data-if="cpp" style="display:none">"correspondence_image"</span><span data-if="com" style="display:none">"correspondence_image"</span><span data-if="dotnet" style="display:none">"correspondence_image"</span><span data-if="python" style="display:none">"correspondence_image"</span></i>:</b></dt>
<dd><p>

Image that describes the correspondences between the monitor and the
camera. If the decoding has been performed in vertical and horizontal
direction, both correspondence images are returned in an array.
Otherwise, only the image of the appropriate direction is returned.
</p></dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'pattern_region'</span><span data-if="c" style="display:none">"pattern_region"</span><span data-if="cpp" style="display:none">"pattern_region"</span><span data-if="com" style="display:none">"pattern_region"</span><span data-if="dotnet" style="display:none">"pattern_region"</span><span data-if="python" style="display:none">"pattern_region"</span></i>:</b></dt>
<dd><p>

Segmented region in which the camera images have been decoded. This
region is identical to the domain of the correspondence images.
</p></dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'defect_image'</span><span data-if="c" style="display:none">"defect_image"</span><span data-if="cpp" style="display:none">"defect_image"</span><span data-if="com" style="display:none">"defect_image"</span><span data-if="dotnet" style="display:none">"defect_image"</span><span data-if="python" style="display:none">"defect_image"</span></i>:</b></dt>
<dd><p>

Image that describes possible defects on the surface which reflects
the projected patterns towards the camera. Basically,
high gray values in the defect image indicate that the gradients of
the correspondence images differ significantly from gradients in the
neighborhood.
</p></dd>
</dl>
<h3>Objects that can be accessed only when in persistence mode:</h3>
<p>
If the decoding has been performed in vertical and horizontal
direction, images of both directions are returned in an array.
Otherwise, only the images of the appropriate direction are returned.
</p>
<dl class="generic">

<dt><b><i><span data-if="hdevelop" style="display:inline">'binarized_image'</span><span data-if="c" style="display:none">"binarized_image"</span><span data-if="cpp" style="display:none">"binarized_image"</span><span data-if="com" style="display:none">"binarized_image"</span><span data-if="dotnet" style="display:none">"binarized_image"</span><span data-if="python" style="display:none">"binarized_image"</span></i>:</b></dt>
<dd><p>

Images of the Gray code sequence where white and black gray values
indicate that the camera pixel observed reflections of white or black
regions of the projected patterns. If <i><span data-if="hdevelop" style="display:inline">'normalization'</span><span data-if="c" style="display:none">"normalization"</span><span data-if="cpp" style="display:none">"normalization"</span><span data-if="com" style="display:none">"normalization"</span><span data-if="dotnet" style="display:none">"normalization"</span><span data-if="python" style="display:none">"normalization"</span></i> was set
to <i><span data-if="hdevelop" style="display:inline">'inverted_pattern'</span><span data-if="c" style="display:none">"inverted_pattern"</span><span data-if="cpp" style="display:none">"inverted_pattern"</span><span data-if="com" style="display:none">"inverted_pattern"</span><span data-if="dotnet" style="display:none">"inverted_pattern"</span><span data-if="python" style="display:none">"inverted_pattern"</span></i> using
<a href="set_structured_light_model_param.html"><code><span data-if="hdevelop" style="display:inline">set_structured_light_model_param</span><span data-if="c" style="display:none">set_structured_light_model_param</span><span data-if="cpp" style="display:none">SetStructuredLightModelParam</span><span data-if="com" style="display:none">SetStructuredLightModelParam</span><span data-if="dotnet" style="display:none">SetStructuredLightModelParam</span><span data-if="python" style="display:none">set_structured_light_model_param</span></code></a>, this refers to the first image
of an inverted pair.
</p></dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'decoded_phase_shift_image'</span><span data-if="c" style="display:none">"decoded_phase_shift_image"</span><span data-if="cpp" style="display:none">"decoded_phase_shift_image"</span><span data-if="com" style="display:none">"decoded_phase_shift_image"</span><span data-if="dotnet" style="display:none">"decoded_phase_shift_image"</span><span data-if="python" style="display:none">"decoded_phase_shift_image"</span></i>:</b></dt>
<dd><p>

Decoded phase shift images containing the phase or angle corresponding
to the projected phase images. One phase period covers stripes in the
projected pattern of an extent <i><span data-if="hdevelop" style="display:inline">'min_stripe_width'</span><span data-if="c" style="display:none">"min_stripe_width"</span><span data-if="cpp" style="display:none">"min_stripe_width"</span><span data-if="com" style="display:none">"min_stripe_width"</span><span data-if="dotnet" style="display:none">"min_stripe_width"</span><span data-if="python" style="display:none">"min_stripe_width"</span></i>.
</p></dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'decoded_single_stripe_image'</span><span data-if="c" style="display:none">"decoded_single_stripe_image"</span><span data-if="cpp" style="display:none">"decoded_single_stripe_image"</span><span data-if="com" style="display:none">"decoded_single_stripe_image"</span><span data-if="dotnet" style="display:none">"decoded_single_stripe_image"</span><span data-if="python" style="display:none">"decoded_single_stripe_image"</span></i>:</b></dt>
<dd><p>

Decoded single stripe image computed solely from the single stripe
images. The correspondence image is a combination of this image with the
Gray code and phase shift images, if <i><span data-if="hdevelop" style="display:inline">'pattern_type'</span><span data-if="c" style="display:none">"pattern_type"</span><span data-if="cpp" style="display:none">"pattern_type"</span><span data-if="com" style="display:none">"pattern_type"</span><span data-if="dotnet" style="display:none">"pattern_type"</span><span data-if="python" style="display:none">"pattern_type"</span></i> is set to
<i><span data-if="hdevelop" style="display:inline">'single_stripe'</span><span data-if="c" style="display:none">"single_stripe"</span><span data-if="cpp" style="display:none">"single_stripe"</span><span data-if="com" style="display:none">"single_stripe"</span><span data-if="dotnet" style="display:none">"single_stripe"</span><span data-if="python" style="display:none">"single_stripe"</span></i>.
</p></dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'gray_code_correspondence_image'</span><span data-if="c" style="display:none">"gray_code_correspondence_image"</span><span data-if="cpp" style="display:none">"gray_code_correspondence_image"</span><span data-if="com" style="display:none">"gray_code_correspondence_image"</span><span data-if="dotnet" style="display:none">"gray_code_correspondence_image"</span><span data-if="python" style="display:none">"gray_code_correspondence_image"</span></i>:</b></dt>
<dd><p>

Correspondence image computed solely from the Gray code images.
If <i><span data-if="hdevelop" style="display:inline">'pattern_type'</span><span data-if="c" style="display:none">"pattern_type"</span><span data-if="cpp" style="display:none">"pattern_type"</span><span data-if="com" style="display:none">"pattern_type"</span><span data-if="dotnet" style="display:none">"pattern_type"</span><span data-if="python" style="display:none">"pattern_type"</span></i> is set to
<i><span data-if="hdevelop" style="display:inline">'gray_code_and_phase_shift'</span><span data-if="c" style="display:none">"gray_code_and_phase_shift"</span><span data-if="cpp" style="display:none">"gray_code_and_phase_shift"</span><span data-if="com" style="display:none">"gray_code_and_phase_shift"</span><span data-if="dotnet" style="display:none">"gray_code_and_phase_shift"</span><span data-if="python" style="display:none">"gray_code_and_phase_shift"</span></i>, the
actual correspondence image is a combination of this image with the
decoded phase shift images.
If <i><span data-if="hdevelop" style="display:inline">'pattern_type'</span><span data-if="c" style="display:none">"pattern_type"</span><span data-if="cpp" style="display:none">"pattern_type"</span><span data-if="com" style="display:none">"pattern_type"</span><span data-if="dotnet" style="display:none">"pattern_type"</span><span data-if="python" style="display:none">"pattern_type"</span></i> is set to <i><span data-if="hdevelop" style="display:inline">'single_stripe'</span><span data-if="c" style="display:none">"single_stripe"</span><span data-if="cpp" style="display:none">"single_stripe"</span><span data-if="com" style="display:none">"single_stripe"</span><span data-if="dotnet" style="display:none">"single_stripe"</span><span data-if="python" style="display:none">"single_stripe"</span></i>, the
actual correspondence image is a combination of this image with the
decoded phase shift images and the decoded single stripe images.
</p></dd>
</dl>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  <li>未经并行化处理。</li>
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="Object" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Object</span><span data-if="c" style="display:none">Object</span><span data-if="cpp" style="display:none">Object</span><span data-if="com" style="display:none">Object</span><span data-if="dotnet" style="display:none">objectVal</span><span data-if="python" style="display:none">object</span></code></b> (output_object)  </span><span>(multichannel-)object(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HObject.html">HObject</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HObject.html">HObject</a></span><span data-if="c" style="display:none">Hobject *</span></span>
</div>
<p class="pardesc">Iconic result.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="StructuredLightModel" class="parname"><b><code><span data-if="hdevelop" style="display:inline">StructuredLightModel</span><span data-if="c" style="display:none">StructuredLightModel</span><span data-if="cpp" style="display:none">StructuredLightModel</span><span data-if="com" style="display:none">StructuredLightModel</span><span data-if="dotnet" style="display:none">structuredLightModel</span><span data-if="python" style="display:none">structured_light_model</span></code></b> (input_control)  </span><span>structured_light_model <code>→</code> <span data-if="dotnet" style="display:none"><a href="HStructuredLightModel.html">HStructuredLightModel</a>, </span><span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">HHandle</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (handle)</span><span data-if="dotnet" style="display:none"> (<i>IntPtr</i>)</span><span data-if="cpp" style="display:none"> (<i>HHandle</i>)</span><span data-if="c" style="display:none"> (<i>handle</i>)</span></span>
</div>
<p class="pardesc">Handle of the structured light model.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="ObjectName" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ObjectName</span><span data-if="c" style="display:none">ObjectName</span><span data-if="cpp" style="display:none">ObjectName</span><span data-if="com" style="display:none">ObjectName</span><span data-if="dotnet" style="display:none">objectName</span><span data-if="python" style="display:none">object_name</span></code></b> (input_control)  </span><span>string(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">MaybeSequence[str]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Name of the iconic result to be returned.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'correspondence_image'</span>
    <span data-if="c" style="display:none">"correspondence_image"</span>
    <span data-if="cpp" style="display:none">"correspondence_image"</span>
    <span data-if="com" style="display:none">"correspondence_image"</span>
    <span data-if="dotnet" style="display:none">"correspondence_image"</span>
    <span data-if="python" style="display:none">"correspondence_image"</span>
</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span><span data-if="hdevelop" style="display:inline">'correspondence_image'</span><span data-if="c" style="display:none">"correspondence_image"</span><span data-if="cpp" style="display:none">"correspondence_image"</span><span data-if="com" style="display:none">"correspondence_image"</span><span data-if="dotnet" style="display:none">"correspondence_image"</span><span data-if="python" style="display:none">"correspondence_image"</span>, <span data-if="hdevelop" style="display:inline">'pattern_region'</span><span data-if="c" style="display:none">"pattern_region"</span><span data-if="cpp" style="display:none">"pattern_region"</span><span data-if="com" style="display:none">"pattern_region"</span><span data-if="dotnet" style="display:none">"pattern_region"</span><span data-if="python" style="display:none">"pattern_region"</span>, <span data-if="hdevelop" style="display:inline">'decoded_single_stripe_image'</span><span data-if="c" style="display:none">"decoded_single_stripe_image"</span><span data-if="cpp" style="display:none">"decoded_single_stripe_image"</span><span data-if="com" style="display:none">"decoded_single_stripe_image"</span><span data-if="dotnet" style="display:none">"decoded_single_stripe_image"</span><span data-if="python" style="display:none">"decoded_single_stripe_image"</span>, <span data-if="hdevelop" style="display:inline">'binarized_image'</span><span data-if="c" style="display:none">"binarized_image"</span><span data-if="cpp" style="display:none">"binarized_image"</span><span data-if="com" style="display:none">"binarized_image"</span><span data-if="dotnet" style="display:none">"binarized_image"</span><span data-if="python" style="display:none">"binarized_image"</span>, <span data-if="hdevelop" style="display:inline">'decoded_phase_shift_image'</span><span data-if="c" style="display:none">"decoded_phase_shift_image"</span><span data-if="cpp" style="display:none">"decoded_phase_shift_image"</span><span data-if="com" style="display:none">"decoded_phase_shift_image"</span><span data-if="dotnet" style="display:none">"decoded_phase_shift_image"</span><span data-if="python" style="display:none">"decoded_phase_shift_image"</span>, <span data-if="hdevelop" style="display:inline">'gray_code_correspondence_image'</span><span data-if="c" style="display:none">"gray_code_correspondence_image"</span><span data-if="cpp" style="display:none">"gray_code_correspondence_image"</span><span data-if="com" style="display:none">"gray_code_correspondence_image"</span><span data-if="dotnet" style="display:none">"gray_code_correspondence_image"</span><span data-if="python" style="display:none">"gray_code_correspondence_image"</span>, <span data-if="hdevelop" style="display:inline">'defect_image'</span><span data-if="c" style="display:none">"defect_image"</span><span data-if="cpp" style="display:none">"defect_image"</span><span data-if="com" style="display:none">"defect_image"</span><span data-if="dotnet" style="display:none">"defect_image"</span><span data-if="python" style="display:none">"defect_image"</span></p>
</div>
<h2 id="sec_example_all">例程 (HDevelop)</h2>
<pre class="example">
* Create the model
create_structured_light_model ('deflectometry', StructuredLightModel)
* Generate the patterns to project
gen_structured_light_pattern (PatternImages, StructuredLightModel)
* Decode the camera images
decode_structured_light_pattern (CameraImages, StructuredLightModel)
* Get the computed correspondences and defects
get_structured_light_object (CorrespondenceImages, StructuredLightModel, \
                             'correspondence_image')
set_structured_light_model_param (StructuredLightModel, \
                                  'derivative_sigma', Sigma)
get_structured_light_object (DefectImage, StructuredLightModel, \
                             'defect_image')
</pre>
<h2 id="sec_result">结果</h2>
<p>该算子 <code><span data-if="hdevelop" style="display:inline">get_structured_light_object</span><span data-if="c" style="display:none">get_structured_light_object</span><span data-if="cpp" style="display:none">GetStructuredLightObject</span><span data-if="com" style="display:none">GetStructuredLightObject</span><span data-if="dotnet" style="display:none">GetStructuredLightObject</span><span data-if="python" style="display:none">get_structured_light_object</span></code> 返回值
<TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
     if the given parameters are valid. Otherwise, an exception will be
raised.</p>
<h2 id="sec_predecessors">可能的前置算子</h2>
<p>
<code><a href="decode_structured_light_pattern.html"><span data-if="hdevelop" style="display:inline">decode_structured_light_pattern</span><span data-if="c" style="display:none">decode_structured_light_pattern</span><span data-if="cpp" style="display:none">DecodeStructuredLightPattern</span><span data-if="com" style="display:none">DecodeStructuredLightPattern</span><span data-if="dotnet" style="display:none">DecodeStructuredLightPattern</span><span data-if="python" style="display:none">decode_structured_light_pattern</span></a></code>
</p>
<h2 id="sec_successors">可能的后置算子</h2>
<p>
<code><a href="clear_structured_light_model.html"><span data-if="hdevelop" style="display:inline">clear_structured_light_model</span><span data-if="c" style="display:none">clear_structured_light_model</span><span data-if="cpp" style="display:none">ClearStructuredLightModel</span><span data-if="com" style="display:none">ClearStructuredLightModel</span><span data-if="dotnet" style="display:none">ClearStructuredLightModel</span><span data-if="python" style="display:none">clear_structured_light_model</span></a></code>
</p>
<h2 id="sec_see">参考其它</h2>
<p>
<code><a href="gen_structured_light_pattern.html"><span data-if="hdevelop" style="display:inline">gen_structured_light_pattern</span><span data-if="c" style="display:none">gen_structured_light_pattern</span><span data-if="cpp" style="display:none">GenStructuredLightPattern</span><span data-if="com" style="display:none">GenStructuredLightPattern</span><span data-if="dotnet" style="display:none">GenStructuredLightPattern</span><span data-if="python" style="display:none">gen_structured_light_pattern</span></a></code>
</p>
<h2 id="sec_module">模块</h2>
<p>
3D Metrology</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
